{\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf410
{\fonttbl\f0\fswiss\fcharset77 Helvetica-Bold;\f1\fswiss\fcharset77 Helvetica;\f2\fmodern\fcharset77 Courier-Bold;
\f3\fswiss\fcharset77 Helvetica-Oblique;}
{\colortbl;\red255\green255\blue255;\red255\green0\blue0;}
{\*\listtable{\list\listtemplateid1\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc2\leveljcn2\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{hyphen\}}{\leveltext\leveltemplateid0\'02\'05.;}{\levelnumbers\'01;}}{\listname ;}\listid1}}
{\*\listoverridetable{\listoverride\listid1\listoverridecount0\ls1}}
\paperw15840\paperh12240\margl1440\margr1440\vieww16300\viewh15580\viewkind0
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f0\b\fs28 \cf0 \
Gobble RSS\

\f1\b0\fs24 \

\f0\b Author
\f1\b0 : Guillaume Boudreau\

\f0\b License
\f1\b0 : GNU Lesser Public License\

\f0\b Homepage
\f1\b0 : {\field{\*\fldinst{HYPERLINK "http://GobbleRss.pommepause.com/"}}{\fldrslt http://GobbleRSS.pommepause.com/}}\

\f0\b Code repository
\f1\b0 : {\field{\*\fldinst{HYPERLINK "http://code.google.com/p/gobblerss/"}}{\fldrslt http://code.google.com/p/gobblerss/}}\
\

\f0\b Thanks to:\
{\field{\*\fldinst{HYPERLINK "http://script.aculo.us/"}}{\fldrslt 
\f1\b0 script.aculo.us}}
\f1\b0  : easy-to-use, cross-browser user interface JavaScript libraries to make your web sites and web applications fly.\
{\field{\*\fldinst{HYPERLINK "http://magpierss.sourceforge.net/"}}{\fldrslt MagpieRSS}} : XML-based (expat) RSS parser in PHP.\
{\field{\*\fldinst{HYPERLINK "http://phputf8.sourceforge.net/"}}{\fldrslt phputf8}} : Tools for working with UTF-8 in PHP.\
\
\

\f0\b Requirements\

\f1\b0 \
\pard\tx220\tx720\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\li720\fi-720\ql\qnatural\pardirnatural
\ls1\ilvl0\cf0 {\listtext	\uc0\u8259 	}A MySQL database;\
{\listtext	\uc0\u8259 	}A PHP-enabled host;\
{\listtext	\uc0\u8259 	}(Optional) A host that allow .htaccess files and AuthUserFile (password protection) commands.\
{\listtext	\uc0\u8259 	}(Optional) libcurl PHP extension if you want to publish starred items to ma.gnolia.\
{\listtext	\uc0\u8259 	}Firefox is strongly recommended; GobbleRSS has never been tested on IE (6 or 7).\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
\cf0 \
\

\f0\b What is GobbleRSS\

\f1\b0 \
GobbleRSS is a web-based RSS reader inspired from the previous version of Google Reader.\
\
It was developed as an alternative to Google Reader for people who need to access their RSS articles from home or work, but with the possibility to download unread articles to a PDA.\
Since Google Reader doesn't yet have a public API that would allow a PDA to grab the latest unread articles, GobbleRSS was developed to allow PDA sync applications to download a single web page that contains a certain number of unread articles. You can then read those articles on the go.\
\
\

\f0\b Installation instructions\

\f1\b0 \
1. Create the MySQL database and user:\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f2\b \cf0 	CREATE DATABASE gobblerss;\
	GRANT ALL ON gobblerss.* TO gobblerss_user@localhost IDENTIFIED BY 'some_password';\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f1\b0 \cf0 Those are examples; all those values can be changed to fit your needs.\
\
2. Edit config.inc.php:\
	a) 
\f0\b URI
\f1\b0  should point to the URL when GobbleRSS will be available.\
	b) 
\f0\b log_file
\f1\b0  should point to a log file where logs will be kept. Leave it empty '' if you don't want any log. This file should be editable by the user running the web server (usually apache).\
	c) 
\f0\b mysql_xyz
\f1\b0  are the information required to connect to your MySQL database.\
	d) 
\f0\b max_articles_per_spider_page
\f1\b0  is the number of articles that will be shown on the 'spider' page (i.e. the page used for PDA syncing). Ignore if you won't use that.\
	e) The other options are configuration options for your Starred Articles RSS feed. They should be self-explanatory.\
\
3. Edit 
\f0\b .htaccess
\f1\b0  to fit your needs. I personally allow my home IP to access the website without passwords (
\f2\b Allow from my_ip
\f1\b0  lines), and I setup a password for when I want to read my RSS feeds from somewhere else. The default 
\f0\b .htaccess
\f1\b0  will only allow 127.0.0.1 and has no password (the password lines are commented out). You'll need to either add another 
\f2\b Allow from xyz
\f1\b0  line with your IP address, or create your own htpasswd and uncomment the appropriate lines.\
\
4. Upload all the files to your web host.\
\
5. Make sure the cache directory is writable by the user running the web server:\
	Example: 
\f2\b chown apache /path/to/gobblerss/cache
\f1\b0 \
Or you can make it world writable (777):\
	Example: 
\f2\b chmod 777 /path/to/gobblerss/cache
\f1\b0 \
You FTP client probably has an option to change file & directories permissions.\
\
6. (Optional) Also make sure the log file your specified in the config.inc.php is writable by the user running the web server:\
	Example: 
\f2\b chown apache /path/to/gobblerss/GobbleRSS.log
\f1\b0 \
\
7.a) If you have access to cron, create a cron job to call http://your_url_for_gobblerss/ping.php at regular interval (I suggest every 6 hours).\
	Example: 
\f2\b 0 */6 * * *	curl -s -o /dev/null http://your_url_for_gobblerss/ping.php
\f1\b0 \
You'll need to edit 
\f0\b .htaccess
\f1\b0  and change the first IP you'll find to the IP of your web host. This is the IP that is allowed to call ping.php - you don't want to allow anyone to call the URL!\
\
b) If you don't have access to cron, you can use the GobbleRSS Ping-Service available here: {\field{\*\fldinst{HYPERLINK "http://ping.gobblerss.pommepause.com/"}}{\fldrslt http://ping.gobblerss.pommepause.com/}}\
Simply enter your 
\f0\b http://your_url_for_gobblerss
\f1\b0  in the form on this website, and the Ping-Service will ping your GobbleRSS at regular intervals.\
The GobbleRSS Ping-Service should start pinging your installation within 15 minutes after you submitted the web form.\
\
You're all set. Point your browser to 
\f0\b http://your_url_for_gobblerss
\f1\b0  to start using GobbleRSS. The 
\f0\b Subscriptions
\f1\b0  link is probably a good start!\
\
Optionally, if you already use another RSS reader and you want to import your feeds into GobbleRSS, you can use the OPML loader.\
\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
\cf0 (Google Reader can export subscriptions in OPML format - in the settings pages I think).\
\
Simply upload the OPML file exported by your RSS reader on your web host, in the same directory as load_opml.php, and load this URL in your browser (change 
\f3\i filename.opml
\f1\i0  to the filename you just uploaded):\

\f0\b http://
\f2 your_url_for_gobblerss
\f0 /load_opml.php?file=filename.opml
\f1\b0 \
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
\cf0 \

\f0\b How to Use GobbleRSS\

\f1\b0 \
On your GobbleRSS homepage, you'll see:\
- all unread articles (left column);\
- the currently highlighted article text (right box);\
- a drop down menu to go to other pages to: manage your subscriptions, view statistics, view your Starred Items RSS feed;\
- a link to force GobbleRSS to grab all the latest RSS articles from all your feed (top-right);\
- a search box (top-right);\
- a 'search by id' box (top-right);\
- keyboard shortcuts to browse articles are shown at the bottom.\
\

\f0\b Read Articles
\f1\b0 : Simply load 
\f0\b http://your_url_for_gobblerss
\f1\b0  and start reading your articles. They are sorted by date, ascending (the oldest articles are the one you'll see first).\
Navigate either using your mouse, or using the keyboard shortcuts (
\f0\b J
\f1\b0  and 
\f0\b K
\f1\b0 ).\
When you find an interresting article, you can either click the article title or hit 
\f0\b V or O or space
\f1\b0  to view the original post on it's website. A new window (or tab) will always open when you select to view the original article.\

\f0\b U
\f1\b0  will allow you to keep the current article unread (come back to it later)\

\f0\b S
\f1\b0  will allow you to star the current article.\
\
When you find an article worthy of a star, simply click the 
\f0\b start this!
\f1\b0  link found under the article title.\
When you find an article you want to review later, simple click the 
\f0\b keep this unread
\f1\b0  link found under the article title.\
Both actions can be undone by clicking again the appropriate links.\
\

\f0\b Starred Articles
\f1\b0 : If you want to share your starred items with your friend, simply give them the URL under the 
\f0\b Starred Items RSS Feed
\f1\b0  link. They can add this RSS feed to any RSS viewer they might be using. GobbleRSS also has an option to publish starred items to your {\field{\*\fldinst{HYPERLINK "http://ma.gnolia.com"}}{\fldrslt ma.gnolia}} account.\
\

\f0\b Forced Update
\f1\b0 : If you want to force GobbleRSS to update all your subscriptions to receive the latest articles, click the 
\f0\b Grab latest
\f1\b0  link. The web page won't change - the link will simply be transformed into a 
\f0\b Loading...
\f1\b0  tag. Once all your subscriptions have been updated, the word 
\f0\b Done
\f1\b0  will be shown where the link was. Simply refresh the GobbleRSS web page to view all the unread articles, including the new ones. This allows you to keep reading your articles while GobbleRSS is fetching new articles.\
If you don't ever force update, new articles will be fetched whenever your GobbleRSS gets 
\f3\i pinged
\f1\i0 .\
\

\f0\b Search
\f1\b0 : If you want to find an article, use the search box. Enter any combination of words, and GobbleRSS will search all articles, new or read, to find those words in either title or article's text. The search box 
\f0\b doesn't
\f1\b0  (yet?) support boolean operators (AND, OR) or exact matching with double quotes.\
\

\f0\b PDA
\f1\b0 : To sync your PDA with unread articles, first select the number of articles you want to download on each sync (in config.inc.php). I personally use 250; this is about the number of articles I'm able to read during my daily commuting to/from work.\
Next, point your PDA webpage sync application (I use {\field{\*\fldinst{HYPERLINK "http://www.plkr.org/"}}{\fldrslt Plucker}} with my Palm) to 
\f0\b http://your_url_for_gobblerss/spider_articles.php
\f1\b0 \
This web page will show all unread articles, up to the maximum you specified in your configuration *and* will mark all of them as read.\
\
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f0\b \cf2 !!!Warning!!!
\f1\b0  Do 
\f0\b not
\f1\b0  load that page yourself in a browser\cf0  - it would mark all the articles shown as 'read', forcing you to read them all now and then, before you close that browser window. If you really want to load it in your browser during your tests, use this URL: \
\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural

\f0\b \cf0 http://your_url_for_gobblerss/spider_articles.php?test
\f1\b0 \cf2 \
\cf0 \
You can then read your articles on your PDA. If you find articles that you'd wish to review later, simply note the articles number (ID) that appear next to the articles title on your PDA. When you're in front of your computer, simply enter the numbers you're interested in reviewing in the GobbleRSS web form (top-right, right-most field).\
}